===========================================================
  REAZIX BILLING SOFTWARE
  By Reazix - one payment, yours to keep
===========================================================

  Your invoices, clients and data stay on THIS computer.
  Nothing is uploaded. No account. No monthly fee.


-----------------------------------------------------------
  EASIEST: INSTALL WITH ONE LINE (no ZIP, no warnings)
-----------------------------------------------------------

  Windows: press Windows + R, paste this line, press Enter:

    powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol='Tls12'; irm https://billing.reazix.com/install.ps1 | iex"

  Mac / Linux: open Terminal, paste this line, press Return:

    curl -fsSL https://billing.reazix.com/install.sh | bash

  It installs the app, adds an icon and opens it. The same
  line later updates it (your data is kept and backed up)
  or repairs it. Or use this ZIP: follow the steps below.


-----------------------------------------------------------
  STEP 1 - EXTRACT THIS FOLDER FIRST
-----------------------------------------------------------

  If you are reading this INSIDE the ZIP file, stop and
  extract it first. The app cannot run from inside a ZIP.

    1. Close this window.
    2. Right-click the ZIP file you downloaded.
    3. Choose "Extract All..." then "Extract".
    4. Open the new folder that appears.

  Keep every file together in that folder. The launcher
  needs the "_system" folder that sits next to it.


-----------------------------------------------------------
  STEP 2 - OPEN THE LAUNCHER FOR YOUR COMPUTER
-----------------------------------------------------------

  Double-click the one that matches your computer:

    Windows ..... Reazix Billing - WINDOWS
    Mac ......... Reazix Billing - MAC
    Linux / NAS . Reazix Billing - LINUX

  A small window opens with one button.

  MAC: install Node.js first (free): https://nodejs.org ->
  macOS Installer (LTS). Then hold Control, click
  "Reazix Billing - MAC" and choose Open, then Open again.
  A Terminal window asks "Install now? [Y/n]": press Return.

  LINUX: see the step-by-step guide below.

  STEP-BY-STEP GUIDES, for every computer, with every click
  explained (no technical knowledge needed):
  https://billing.reazix.com/help/install.html


-----------------------------------------------------------
  STEP 3 - CLICK INSTALL, THEN WAIT
-----------------------------------------------------------

  Click "Install". There is nothing to fill in.

  It sets everything up (if this PC has no Node.js, the
  engine the app runs on, it downloads it: about 30 MB, one
  time) and then opens the app in your web browser by
  itself. Takes 1 to 3 minutes.

  A black window appears while it works. Leave it alone -
  it closes on its own.

  You do NOT need administrator rights. Nothing is added to
  Windows outside this folder.

  Windows may warn "Windows protected your PC" because this
  app is not code-signed (a certificate costs about $300 a
  year, which would defeat the word "free"). Click
  "More info", then "Run anyway".


-----------------------------------------------------------
  FROM NOW ON
-----------------------------------------------------------

  A "Reazix Billing" icon is put on your Desktop and in
  the Start menu. Click it to open the app every day: it
  starts the app and opens it in its own window.

  Update, Back up, Restore and Stop are also in the app's
  Control Panel. The launcher stays in this folder for
  updates and repairs:

    Open App .......... starts the app
    More options ...... Update, Back up, Restore,
                        Move to another PC, Stop


-----------------------------------------------------------
  YOUR FIRST INVOICE, IN 5 MINUTES
-----------------------------------------------------------

  1. The first time it opens, a short wizard asks for your
     business name, address and GSTIN. Fill it in - this is
     what prints at the top of every invoice. You can change
     it later in Settings.

  2. Click "+ New Invoice" at the top.

  3. Type your client's name. Enter their GSTIN and the
     state fills in by itself.

  4. Add what you sold: description, quantity, rate, tax %.
     The GST is worked out for you - CGST + SGST inside your
     state, IGST outside it.

  5. Click "Download PDF". The invoice is saved and numbered
     automatically.

  That is a complete, GST-compliant tax invoice.


-----------------------------------------------------------
  WHERE IS MY DATA?
-----------------------------------------------------------

  In the "_system\data" folder, inside this folder. Plain
  files on your own disk - you can copy them anywhere.

  Back it up with "More options -> Back up my data", which
  writes a ZIP to:

    Documents\Reazix Billing Backups

  Updating the app NEVER touches your data, and the updater
  takes its own backup before it starts.


-----------------------------------------------------------
  IF SOMETHING GOES WRONG - FIX IT YOURSELF
-----------------------------------------------------------

  Find the message you see. Your invoices are never lost
  by any of these: they stay in "_system\data".

  "Some files are missing" / "extract the ZIP first"
      The ZIP was not fully extracted, or the launcher was
      opened from inside the ZIP. Go back to STEP 1.

  "Windows protected your PC"
      Click "More info", then "Run anyway" (see STEP 3).

  Mac: "could not be executed because you do not have
  appropriate access privileges"
      Open Terminal (Applications -> Utilities), type
      chmod +x  (with a space after it), drag the file
      "Reazix Billing - MAC" into the Terminal window,
      press Enter, then open the file again.

  Mac: "cannot be opened because Apple cannot check it" /
  "unidentified developer"
      The app is not signed by Apple. Hold Control and click
      "Reazix Billing - MAC", choose Open, then Open again.
      Only the first time. (Or: System Settings -> Privacy &
      Security -> Open Anyway.)

  "Node.js ... is too old", "npm ERR!", or a file called
  "npm-debug.log" in the _system folder
      This PC has an old Node.js (the engine the app runs
      on). Version 1.10.81 and later set up a new one inside
      this folder by themselves: just click Install or Open
      App again. On an older version:
        1. Install "Node.js LTS" from https://nodejs.org
           (default options).
        2. Open the "_system" folder. It is hidden: in File
           Explorer click View -> Show -> Hidden items.
        3. Delete the folder "node_modules" ONLY.
           Never delete the "data" folder.
        4. Open the launcher and click Install.

  "could not install the app's dependencies" /
  "cannot reach the internet"
      Check the connection (open any website). At an
      office, a proxy or firewall may block nodejs.org or
      billing.reazix.com. Then click Install again - it carries on
      where it stopped. Or paste the one-line install from
      the top of this file: it also repairs.

  "Still starting..." / "The server has not answered in
  90 seconds"
      The first start after an install or update is slow
      (antivirus checks every new file). Wait a minute and
      open http://localhost:47371 in your browser. Still
      nothing? Close the black window and open the app
      again from its icon.

  "Reazix Billing is already installed on this computer"
      You extracted a new ZIP into a new folder. Your
      invoices are in the folder it names. Click "Update
      the installed copy" in the launcher, then delete the
      new folder.

  "The app cannot write to its own folder"
      Do not keep it in C:\Program Files. Move the whole
      Reazix-Billing folder to Documents or D:\ and open
      it from there.

  "Drive ... is almost full"
      The install needs about 400 MB free. Empty the
      Recycle Bin or delete old downloads.

  "Node.js was downloaded but will not run"
      Your antivirus removed it. Add this folder to the
      antivirus exclusions and click Install again.

  "Cannot connect to server" / "This site can't be
  reached" / a blank page
      The app is not running. Click the Reazix Billing
      icon on your Desktop.

  The update finished but the app looks the same
      Reload the page with Ctrl + F5.

  Forgot the PIN?
      In this folder (next to the launcher) make a new text
      file named RESET-PIN, then reload the app. The PIN is
      removed; your invoices are not touched.

  Still stuck?
      Email us, with a screenshot (hide your GSTIN and
      bank details) and the message you see:
      contact@reazix.com

      Fixes come in updates, and anything urgent straight away.

      The full guide, with every screen explained:
      https://billing.reazix.com/help/


===========================================================
  Reazix Billing Software - https://reazix.com
  Licence: see LICENSE and THIRD-PARTY-NOTICES.md.
===========================================================
